shared source/sscli_ref_20021101/docs/System.Runtime.Serialization/System.Runtime.Serialization.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html>
   2 <head>
   3 <META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   4 <link rel="stylesheet" type="text/css" href="../refdoc.css">
   5 <title>Namespace: System.Runtime.Serialization</title>
   6 </head>
   7 <body>
   8 <h2>Namespace: System.Runtime.Serialization</h2>
   9 <dl>
  10 <dd>
  11 <p> The  <a href="../System.Runtime.Serialization/System.Runtime.Serialization.html">System.Runtime.Serialization</a> namespace contains classes that can be used for serializing and deserializing objects. Serialization is the process of converting an object or a graph of objects into a linear sequence of bytes for either storage or transmission to another location. Deserialization is the process of taking in stored information and recreating objects from it.</p>
  12 <p> The  <a href="../System.Runtime.Serialization/types/ISerializable.html">ISerializable</a> interface provides a way for classes to control their own serialization behavior. Classes in the  <a href="../System.Runtime.Serialization.Formatters/System.Runtime.Serialization.Formatters.html">System.Runtime.Serialization.Formatters</a> namespace control the actual formatting of various data types encapsulated in the serialized objects.</p>
  13 <p> Formatters that serialize and deserialize objects to and from a particular format can be found in the  <a href="../System.Runtime.Serialization.Formatters/System.Runtime.Serialization.Formatters.html">System.Runtime.Serialization.Formatters</a> namespace.</p>
  14 </dd>
  15 </dl>
  16 <h3>Members of System.Runtime.Serialization Namespace</h3><b>Classes</b><dl>
  17 <dd>
  18 <table border="1" width="90%" style="border-collapse: collapse">
  19 <tr valign="top">
  20 <th bgcolor="#C0C0C0">Class</th>
  21 <th bgcolor="#C0C0C0">
  22                                                         Description
  23                                                 </th>
  24 </tr>
  25 <tr valign="top">
  26 <td width="30%"><a href="types/Formatter.html">class Formatter</a></td>
  27 <td width="60%"> Provides base functionality for the common language runtime serialization formatters.
  28      </td>
  29 </tr>
  30 <tr valign="top">
  31 <td width="30%"><a href="types/FormatterConverter.html">class FormatterConverter</a></td>
  32 <td width="60%"> Represents a base implementation of the  <a href="../System.Runtime.Serialization/types/IFormatterConverter.html">IFormatterConverter</a> interface that uses the  <a href="../System/types/Convert.html">Convert</a> class and the  <a href="../System/types/IConvertible.html">IConvertible</a> interface.
  33      </td>
  34 </tr>
  35 <tr valign="top">
  36 <td width="30%"><a href="types/FormatterServices.html">class FormatterServices</a></td>
  37 <td width="60%"> Provides static methods to aid with the implementation of a  <a href="../System.Runtime.Serialization/types/Formatter.html">Formatter</a> for serialization. This class cannot be inherited.
  38      </td>
  39 </tr>
  40 <tr valign="top">
  41 <td width="30%"><a href="types/ObjectIDGenerator.html">class ObjectIDGenerator</a></td>
  42 <td width="60%"> Generates IDs for objects.
  43      </td>
  44 </tr>
  45 <tr valign="top">
  46 <td width="30%"><a href="types/ObjectManager.html">class ObjectManager</a></td>
  47 <td width="60%"> Keeps track of objects as they are deserialized.
  48      </td>
  49 </tr>
  50 <tr valign="top">
  51 <td width="30%"><a href="types/SerializationBinder.html">class SerializationBinder</a></td>
  52 <td width="60%"> Allows users to control class loading and mandate what class to load.
  53      </td>
  54 </tr>
  55 <tr valign="top">
  56 <td width="30%"><a href="types/SerializationException.html">class SerializationException</a></td>
  57 <td width="60%"> The exception thrown when an error occurs during serialization or deserialization.
  58      </td>
  59 </tr>
  60 <tr valign="top">
  61 <td width="30%"><a href="types/SerializationInfo.html">class SerializationInfo</a></td>
  62 <td width="60%"> Holds all the data needed to serialize or deserialize an object. This class cannot be inherited.
  63      </td>
  64 </tr>
  65 <tr valign="top">
  66 <td width="30%"><a href="types/SerializationInfoEnumerator.html">class SerializationInfoEnumerator</a></td>
  67 <td width="60%"> Provides a formatter-friendly mechanism for parsing the data in  <a href="../System.Runtime.Serialization/types/SerializationInfo.html">SerializationInfo</a>. This class cannot be inherited.
  68      </td>
  69 </tr>
  70 <tr valign="top">
  71 <td width="30%"><a href="types/SurrogateSelector.html">class SurrogateSelector</a></td>
  72 <td width="60%"> Assists formatters in selection of the serialization surrogate to delegate the serialization or deserialization process to.
  73      </td>
  74 </tr>
  75 </table>
  76 </dd>
  77 </dl><br><b>Interfaces</b><dl>
  78 <dd>
  79 <table border="1" width="90%" style="border-collapse: collapse">
  80 <tr valign="top">
  81 <th bgcolor="#C0C0C0">Interface</th>
  82 <th bgcolor="#C0C0C0">
  83                                                         Description
  84                                                 </th>
  85 </tr>
  86 <tr valign="top">
  87 <td width="30%"><a href="types/IDeserializationCallback.html">interface IDeserializationCallback</a></td>
  88 <td width="60%"> Indicates that a class is to be notified when deserialization of the entire object graph has been completed.
  89      </td>
  90 </tr>
  91 <tr valign="top">
  92 <td width="30%"><a href="types/IFormatter.html">interface IFormatter</a></td>
  93 <td width="60%"> Provides functionality for formatting serialized objects.
  94      </td>
  95 </tr>
  96 <tr valign="top">
  97 <td width="30%"><a href="types/IFormatterConverter.html">interface IFormatterConverter</a></td>
  98 <td width="60%"> Provides the connection between an instance of  <a href="../System.Runtime.Serialization/types/SerializationInfo.html">SerializationInfo</a> and the formatter-provided class best suited to parse the data inside the  <a href="../System.Runtime.Serialization/types/SerializationInfo.html">SerializationInfo</a>.
  99      </td>
 100 </tr>
 101 <tr valign="top">
 102 <td width="30%"><a href="types/IObjectReference.html">interface IObjectReference</a></td>
 103 <td width="60%"> Indicates that the current interface implementer is a reference to another object.
 104      </td>
 105 </tr>
 106 <tr valign="top">
 107 <td width="30%"><a href="types/ISerializable.html">interface ISerializable</a></td>
 108 <td width="60%"> Allows an object to control its own serialization and deserialization.
 109      </td>
 110 </tr>
 111 <tr valign="top">
 112 <td width="30%"><a href="types/ISerializationSurrogate.html">interface ISerializationSurrogate</a></td>
 113 <td width="60%"> Implements a serialization surrogate selector that allows one object to perform serialization and deserialization of another.
 114      </td>
 115 </tr>
 116 <tr valign="top">
 117 <td width="30%"><a href="types/ISurrogateSelector.html">interface ISurrogateSelector</a></td>
 118 <td width="60%"> Indicates a serialization surrogate selector class.
 119      </td>
 120 </tr>
 121 </table>
 122 </dd>
 123 </dl><br><b>Structures</b><dl>
 124 <dd>
 125 <table border="1" width="90%" style="border-collapse: collapse">
 126 <tr valign="top">
 127 <th bgcolor="#C0C0C0">Structure</th>
 128 <th bgcolor="#C0C0C0">
 129                                                         Description
 130                                                 </th>
 131 </tr>
 132 <tr valign="top">
 133 <td width="30%"><a href="types/SerializationEntry.html">structure SerializationEntry</a></td>
 134 <td width="60%"> Holds the value,  <a href="../System/types/Type.html">Type</a>, and name of a serialized object.
 135      </td>
 136 </tr>
 137 <tr valign="top">
 138 <td width="30%"><a href="types/StreamingContext.html">structure StreamingContext</a></td>
 139 <td width="60%"> Describes the source and destination of a given serialized stream, as well as a means for serialization to retain that context and an additional caller-defined context.
 140      </td>
 141 </tr>
 142 </table>
 143 </dd>
 144 </dl><br><b>Enumerations</b><dl>
 145 <dd>
 146 <table border="1" width="90%" style="border-collapse: collapse">
 147 <tr valign="top">
 148 <th bgcolor="#C0C0C0">Enumeration</th>
 149 <th bgcolor="#C0C0C0">
 150                                                         Description
 151                                                 </th>
 152 </tr>
 153 <tr valign="top">
 154 <td width="30%"><a href="types/StreamingContextStates.html">enumeration StreamingContextStates</a></td>
 155 <td width="60%"> Defines a set of flags that specifies the source or destination context for the stream during serialization.
 156      </td>
 157 </tr>
 158 </table>
 159 </dd>
 160 </dl><br><b>Namepace hierarchy</b><br><ul class="none">
 161 <li><a href="../System/types/Object.html">System.Object</a></li>
 162 <ul class="none">
 163 <li><a href="../System/types/Exception.html">System.Exception</a></li>
 164 <ul class="none">
 165 <li><a href="../System/types/SystemException.html">System.SystemException</a></li>
 166 <ul class="none">
 167 <li><a href="../System.Runtime.Serialization/types/SerializationException.html">System.Runtime.Serialization.SerializationException</a></li>
 168 </ul>
 169 </ul>
 170 </ul>
 171 <ul class="none">
 172 <li><a href="../System.Runtime.Serialization/types/Formatter.html">System.Runtime.Serialization.Formatter</a> --- <a href="../System.Runtime.Serialization/types/IFormatter.html">System.Runtime.Serialization.IFormatter</a></li>
 173 </ul>
 174 <ul class="none">
 175 <li><a href="../System.Runtime.Serialization/types/FormatterConverter.html">System.Runtime.Serialization.FormatterConverter</a> --- <a href="../System.Runtime.Serialization/types/IFormatterConverter.html">System.Runtime.Serialization.IFormatterConverter</a></li>
 176 </ul>
 177 <ul class="none">
 178 <li><a href="../System.Runtime.Serialization/types/FormatterServices.html">System.Runtime.Serialization.FormatterServices</a></li>
 179 </ul>
 180 <ul class="none">
 181 <li><a href="../System.Runtime.Serialization/types/ObjectIDGenerator.html">System.Runtime.Serialization.ObjectIDGenerator</a></li>
 182 </ul>
 183 <ul class="none">
 184 <li><a href="../System.Runtime.Serialization/types/ObjectManager.html">System.Runtime.Serialization.ObjectManager</a></li>
 185 </ul>
 186 <ul class="none">
 187 <li><a href="../System.Runtime.Serialization/types/SerializationBinder.html">System.Runtime.Serialization.SerializationBinder</a></li>
 188 </ul>
 189 <ul class="none">
 190 <li><a href="../System.Runtime.Serialization/types/SerializationInfo.html">System.Runtime.Serialization.SerializationInfo</a></li>
 191 </ul>
 192 <ul class="none">
 193 <li><a href="../System.Runtime.Serialization/types/SerializationInfoEnumerator.html">System.Runtime.Serialization.SerializationInfoEnumerator</a> --- <a href="../System.Collections/types/IEnumerator.html">System.Collections.IEnumerator</a></li>
 194 </ul>
 195 <ul class="none">
 196 <li><a href="../System.Runtime.Serialization/types/SurrogateSelector.html">System.Runtime.Serialization.SurrogateSelector</a> --- <a href="../System.Runtime.Serialization/types/ISurrogateSelector.html">System.Runtime.Serialization.ISurrogateSelector</a></li>
 197 </ul>
 198 <ul class="none">
 199 <li><a href="../System/types/ValueType.html">System.ValueType</a></li>
 200 <ul class="none">
 201 <li><a href="../System/types/Enum.html">System.Enum</a></li>
 202 <ul class="none">
 203 <li><a href="../System.Runtime.Serialization/types/StreamingContextStates.html">System.Runtime.Serialization.StreamingContextStates</a></li>
 204 </ul>
 205 </ul>
 206 <ul class="none">
 207 <li><a href="../System.Runtime.Serialization/types/SerializationEntry.html">System.Runtime.Serialization.SerializationEntry</a></li>
 208 </ul>
 209 <ul class="none">
 210 <li><a href="../System.Runtime.Serialization/types/StreamingContext.html">System.Runtime.Serialization.StreamingContext</a></li>
 211 </ul>
 212 </ul>
 213 </ul><br><i><a href="../documentation_license.txt">
 214                                   Copyright (c) 2002 Microsoft Corporation.  All rights reserved.
 215                                 </a></i></body>
 216 </html>